package com.tianji.learning.service;

import com.tianji.common.domain.dto.PageDTO;
import com.tianji.common.domain.query.PageQuery;
import com.tianji.learning.domain.dto.LearningPlanDTO;
import com.tianji.learning.domain.po.LearningLesson;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.learning.domain.vo.LearningLessonVO;
import com.tianji.learning.domain.vo.LearningPlanPageVO;

import java.util.List;

/**
 * <p>
 * 学生课程表 服务类
 * </p>
 *
 * @author 东哥
 * @since 2025-06-27
 */
public interface ILearningLessonService extends IService<LearningLesson> {

    /**
     * 1、添加课程至课程表（Day2 - 随堂1）
     * @param userId
     * @param courseIds
     */
    void addLessons(Long userId, List<Long> courseIds);

    /**
     * 2、分页查询我的课表（Day2 - 随堂2）
     * @param pageQuery
     * @return
     */
    PageDTO<LearningLessonVO> pageQueryMyLessons(PageQuery pageQuery);

    /**
     * 3、查询我最近正在学习的课程（Day2 - 随堂3）
     * @return
     */
    LearningLessonVO now();

    /**
     * 4、查询指定课程信息（Day2 - 作业1）
     * @param courseId
     * @return
     */
    LearningLessonVO queryLessonByCourseId(Long courseId);

    /**
     * 5、删除指定课程信息（Day2 - 作业2）
     * @param userId
     * @param courseId
     */
    void deleteCourseFromLesson(Long userId, List<Long> courseIds);

    /**
     * 6、统计课程学习人数（Day2 - 作业3）
     * @param courseId
     * @return
     */
    Integer countLearningLessonByCourse(Long courseId);

    /**
     * 7、校验当前课程是否已经报名（Day2 - 作业4）
     * @param courseId
     * @return
     */
    Long isLessonValid(Long courseId);

    /**
     * 8、创建学习计划（Day3 - 随堂3）
     * @param planDTO
     */
    void createPlans(LearningPlanDTO planDTO);

    /**
     * 9、统计查询我的学习计划（Day3 - 随堂4）
     * @param pageQuery
     * @return
     */
    LearningPlanPageVO queryMyPlans(PageQuery pageQuery);

}
